//**************************************************
// GameBoy Advance Development Environment Setup
//     for Target Board TS2, Development AGB (TS4)
//     2001/2/6 toolSetup.txt
//     Copyright (C) 1999-2001 NINTENDO Co.,Ltd.
//**************************************************

<Introduction>

Here we will explain how to set up the GameBoy Advance (hereinafter AGB) 
development environment. 

<Operating Environment>

Operating system: Windows95/98/NT4.0 SP3 or later
Recommended machine: Machine equipped with at least a Pentium processor
Recommended memory: 64MB or more main memory, 4096 initial environment variables 
                    for DOS (Windows 95/98)
Recommended HDD space: There should be at least 900MB of free space on the hard 
		       drive (if including all the GnuPro tools)
Minimum HDD space: 420MB

* UNIX-based operation and building are not supported.
* Windows 2000 is not supported. 

<Setup Wizard>

1. Double-click on AGBSetup.exe from AGB Developers ToolKit Version 3.0 and 
   install the software as instructed by Install Shield (installation program). 
   Once the setup is completed, the libraries, macros, headers, various samples, 
   and all manuals necessary to develop AGB applications will be installed under 
   the :\agb directory. 

2. Next, double-click on AGBSetup2.exe from the CD (AGB Developers ToolKit 
   Version 3.0) and install the software as instructed by Install Shield 
   (installation program). Once setup is completed, the 16-bit command build 
   environment of thumbelf-000512 for Cygnus Solutions' ARM7TDMI and 
   native-99rl (BASH shell) are installed under the 
   :\Program files\cygnus directory. 

* When changing the install directory, you need to change the setting of 
  AGBDIR,CYGNUSDIR in AgbGNUProBash.bat. This is because the default path of the 
  environmental parameter CYGNUSDIR is presumed to be in the same directory. 
 
* The 32-bit command building environment armelf-XXXXXX is in the root directory 
  of the CD as armelf-000512.zip. It can be copied and used as necessary. 
  (Free space of 460MB is necessary to decompress this file.)

3. This completes the installation of the software. 
   Now, turn off the power to the personal computer (PC). 

4. Now set up the hardware. 
   Have the following items ready.
   -IS-AGB-EMULATOR (or DEBUGGER or CHARACTER or ANIMEVIEWER, etc.)
    {The hardware for which the AGB is set up will be indicated by a checkmark 
    on the label on the back of the unit.}
   -SCSI cable (purchase separately) 
   -Generic SCSI2 card for PC (purchase separately) 
   -Development AGB

5. With the power to the PC off, connect the SCSI card and the IS-AGB-EMULATOR 
   with as short a cable as possible.  See the included manuals for details. 

6. Connect the ribbon cable with cartridge included with IS-AGB-EMULATOR in the
   slot for AGB Game Pak.  
   Next, plug in the red and black power cable that is attached to the 
   Development AGB to the white 6-pin connector on the AGB Game Pak. 
   (Resets and interrupts will have no effect unless this is connected.) 

7. Turn on the power for IS-AGB-EMULATOR and Development AGB.

8. Install the emulator from the CD included with the IS-AGB-EMULATOR. 
   (See the IS-AGB-EMULATOR documentation for details.)

9. SELECT [Start]->[Program]->[IS-AGB-EMULATOR]->[IS-AGB-EMULATOR] to check 
   the operation. 

10. SELECT [File]->[Open] and SELECT BIN from the dialog box.  Then, SELECT 
    [Browse]->[C:\agb\src\samples\functional_sample\fncsample.bin]. 

11. Once the IS-AGB-EMULATOR has been initialized, the data will be transferred to
    the Development AGB.  It is functioning normally if the menu is displayed on
    Development AGB and each function is working. 

12. Next, try compiling the source code. 
    From the Explorer, double click on: 

    {installed drive}:\Program files\cygnus\thumbelf-000512\AgbGNUProBash.bat and 
    start the batch file.

13. The BASH shell will start in the DOS window. 
    If "[/Program Files/Cygnus/thumbelf-000512]" is displayed at the prompt, 
    everything is normal.  In the following description, the prompt will be shown 
    as $. 

* If "Out of environment space" is displayed, either press the 
  Properties button for the AgbGNUProBash.bat batch file, or right click 
  on AgbGNUProBash.bat to select Properties and open a dialog box. 
  Change the parameter of [Memory]->[Environment Variables] to 4096. 

14. $ cd /agb/src/samples/functional_sample
    $ make

    Execute the above two commands in order to perform make. 
    Confirm that fncsample.bin and fncsample.elf are created in the same directory. 

15. Execute fncsample.bin according to the procedure described in step 10 and 
    check its operation. 

16. The preceding confirms that the system is operating under the AGB 
    development environment. 

    Then, from Explorer, open :\agb\doc\AllManuals\index.htm for use in AGB 
    development. 

* This text is stored in the ROOT directory of the CD, as well as in the 
  {installed drive}:\agb\doc directory. 

* The AGB Developers ToolKit includes products from Cygnus Solutions 
  and Free Software Foundation, Inc.  Cygnus Solutions and Free Software 
  Foundation,Inc. owns the copyrights to their products.

* All support for GNUPro and GNUPro Tools should be handled with Redhat 
  and companies with support contracts with Redhat. 
  
   http://www.redhat.com
   http://www.redhat.com/support/ (For support-related inquiries)
 
* As for the tools from Intelligent Systems, the latest versions are available 
  from the following website: 

    http://www.noa-engineering.com

* The various product names and company names used herein are trademarks or 
  registered trademarks of their respective companies. 

*****************************************************************
Please send technical inquiries regarding AGB to the following
e-mail address: support@noa.com
*****************************************************************

END
